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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33 600-87-C-04 64 ,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
.Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Jud;j;'ri, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technoloay 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  T 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


R.QEE 


Control  Data  Corporation 


D.  Appleton  Company 


ONTEK 


Simpact  Corporation 


Responsible  for  the  overall  Comjnon 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFIX  integration 
methodology . 

Responsible  for  defining  and  testir.u 
representative  integrated  system  bar-- 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 


Responsible  for  Communication 
development . 


nv 
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structural  Dynamics 
Research  Corporation 
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Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 


Arizona  State  University 


Responsible  for  test  bed  operations 
and  support . 


CM  C)^ 
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SECTION  1 
SCOPE 


1.1  Identification 


This  specification  establishes  the  'as  built'  design  of  the 
Interprocess  Communication  Primitives  (IPC's). 

1 . 2  Functional  Summary 

The  IPC's  are  the  lowest  level  of  common  services  in  the 
IISS.  Their  function  is  to  supply  a  standard  interface  to 
operating  system  services  normally  required  by  complex  application 
systems.  The  implementation  of  these  routines,  therefore,  is 
highly  system  dependent. 

The  services  they  support  are  passing  messages  between  two 
programs,  starting  and  stoping  a  timer,  and  responding  to  a  series 
of  asynchronous  events. 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 

The  following  pertinent  reference  materials  are  available 
at  the  ICAM  Program  Office. 

1.  Interim  Reports 

2.  Life  Cycle  Documents 

(a)  1TR620150002U  Project  Scope 

(b)  PMP620150000  Master  Plan  and  Schedule 

(c)  SAD620150000  State-of-the-art  Review 

(d)  SRD620140000  System  Requirements  Document 

(e)  SDS620140000  System  Design  Specifications 

(f)  DS6201430000  Development  Specif ication  - 

Communications  Subsystem 

The  following  reference  materials  are  available  from 
Digital  Equipment  Corporation. 

(a)  VAX /VMS  I/O  User's  Guide  (Volume  1) ,  Order  No. 
AA-M540B-TE 

(b)  VAX/VMS  I/O  User's  Guide  (Volume  2) ,  Order  No. 
AA-M541B-TE 

(c)  VAX  COBOL  Language  Reference  Manual,  Order  No. 
AA-H631C-TE 

(d)  VAX-11  FORTRAN  Language  Reference  Manual,  Order 
No.  AA-D034C-TE 

2 . 2  Terms  and  Abbreviations 


All  the  arguments  for  the  iPC's  are  described  in  DS 
620140004  for  the  Communication  Subsystem;  however,  the  more 
important  ones  are  reiterated  here. 

1.  Input  Mailbox  -  the  logical  name  for  a  section  of 
memory  from  which  a  primitive  obtains  a  message  that 
was  send  to  a  program 

2.  Target  Mailbox  -  the  logical  name  for  a  section  of 
memory  into  which  a  primitive  stores  a  message 

3.  Event  Block  -  a  block  of  contiguous  memory,  local  to  a 
program,  into  which  primitives  store  system  dependent 
information  needed  to  perform  their  tasks 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Descriptions 

The  description  of  each  IPC  along  with  its  calling 
sequence,  its  inputs  and  its  outputs  is  given  is  Sections  3.2.7 
and  3.5  of  the  Communication  Subsystem  Development 
Specification,  DS620140004.  Thus,  only  a  list  of  the  IPC's  and 
their  functions  will  be  presented  here. 

3.1.1  Create  a  Mailbox 


The  routine  CRTMBX  creates  a  mailbox  (global  storage  in 
memory)  through  which  a  program  may  receive  messages  from 
another  program  executing  on  the  same  computer  at  the  same  time. 

3.1.2  Send  a  Message  to  Another  Program 

The  routine  SNDMSG  sends  a  message  to  another  program 
executing  on  the  same  computer  at  the  same  time  by  placing  it  in 
the  input  mailbox  (memory)  allocated  to  the  other  program. 

3.1.3  Receive  a  Message  from  Another  Program 

The  routine  RCVMSG  records  the  fact  that  the  program  will 
accept  messages  sent  from  other  programs  to  its  input  mailbox. 
The  routine  returns  to  the  program  allowing  it  to  execute  while 
other  programs  send  messages. 

3.1.4  Get  a  Message  from  Another  Program 

The  routine  GETMSG  removes  a  message  from  the  input 
mailbox  (memory)  of  a  program  and  moves  it  to  the  given  buffer. 

3.1.5  Delete  a  Mailbox 


The  routine  DELMBX  removes  the  capability  of  receiving 
messages  through  the  given  input  mailbox.  Whether  the  memory  is 
released  for  other  uses  at  this  time  depends  upon  the  computer 
and  operating  system  under  which  IISS  runs. 

3.1.6  Release  an  Event  Block 


The  routine  RELEVB  reinitializes  an  event  block  (local 
program  storage)  enabling  it  to  be  used  with  other  primitives. 

It  is  needed  to  clear  an  event  block  when  the  same  event  block 
is  used  with  different  target  mailboxes. 

3.1.7  Start  a  Timer 

The  routine  SETTIM  invokes  a  timing  mechanism  that  will 
cause  an  event  when  the  time  interval  has  elapsed.  After  noting 
the  time,  the  routine  returns  to  the  program  allowing  it  to 
continue  executing. 
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The  routine  CNLTIM  terminates  the  timing  mechanism 
initiated  by  the  SETTIM  routine. 

3.1.9  Wait  for  an  Event  to  Occur 


The  routine  WAITnn  (where  nn  is  the  maximum  number  of 
events  possible)  waits  for  the  completion  of  one  of  the 
outstanding  requests  that  are  associated  with  the  list  of  event 
blocks.  The  program  is  suspended  until  an  event  occurs. 

3.1.10  Terminate  a  Run 


The  routine  ENDRUN  terminates  the  executing  of  the 
program. 

3 . 2  Functional  Flow  Description 

Since  the  implementation  of  the  IPC's  are  system 
dependent,  the  functional  flow  description  must  be  described  in 
context  of  the  computer  and  operating  system.  The  IPC's  were 
implemented  on  the  IBM  3084  under  CICS  and  under  MVS.  They  were 
implemented  on  the  Honeywell  Level  6  under  Mod  400  and  on  the 
VAX  under  VMS. 

3.3  Interfaces 


On  the  IBM,  under  CICS,  the  IPC's  were  implemented  using 
some  CICS  command  level  and  some  macro  level  system  interfaces. 
The  command  level  was  written  in  COBOL,  while  the  macro  level 
was  in  assembler.  This  mixed  mode  format  was  required  because 
not  all  the  necessary  functions  were  available  at  the  command 
level.  There  is  no  mailbox  facility  under  CICS,  so  the  concept 
of  mailbox  had  to  designed  and  implemented  from  scratch. 

Under  MVS,  the  IPC's  were  implemented  in  assembler  as  one 
task  with  different  entry  points  for  each  routine.  Again,  there 
is  no  mailbox  facility  under  MVS.  The  design  developed  for  CICS 
was  reimplemented  for  MVS. 

On  the  Honeywell  Level  6,  the  IPC's  were  again  a  mixture 
of  COBOL  and  assembler  because  the  only  interface  into  the 
system  services  is  through  assembler.  The  Mod  400  operating 
system  supports  a  mailbox  facility  so  calls  to  it  were  used  in 
the  implementation  of  the  IPC's. 

The  VAX  also  has  a  mailbox  facility  and  its  system 
services  are  accessible  through  high  level  languages. 

Therefore,  the  IPC's  on  the  VAX  were  implemented  using  a 
conbination  of  COBOL  and  FORTRAN. 

3 . 4  Interrupts 

This  section  does  not  apply  to  the  IPS's. 
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3 . 5  Timing  and  Sequence  Description 

Timing  and  secjuencing  is  only  relevant  to  the  Wait  for  an 
Event  to  Occur  primitive,  and  then  only  when  it  is  waiting  on 
more  than  one  event.  If  more  than  one  event  has  occurred,  the 
primitive  will  report  to  the  program  the  one  that  has  the 
highest  priority  based  on  event  number. 

3 . 6  Special  Control  Features 

The  Interprocess  Communication  Primitives  do  not  include 
any  special  control  features  as  defined  in  the  ICAM 
Documentations  Standards. 

3 . 7  Storage  Allocation 

3.7.1  Data  Base  Definition 

3.7. 1.1  File  Description 

The  IPC's  do  not  use  any  files. 

3.7. 1.2  Table  Description 

The  IPC's  do  not  use  any  tables. 

3. 7. 1.3  Item  and  Constant  Description 

The  event  block  contains  two  variables  that  are  common 
across  all  implementations.  The  first  is  the  event  type  which 
indicates  whether  the  block  is  being  used  by  an  IPC  receive 
message,  a  timer,  or  a  receive  for  the  Communications  Subsystem. 
The  second  variable  indicates  the  possible  states  of  the 
event--no  event  outstanding,  event  outstanding  but  not 
completed,  event  completed  but  not  requested  by  the  program. 

3.7.2  CPC  Relationship 

The  event  block  is  used  with  every  IPC  except  EMDRUN  and 
LOCKEF. 

3 . 8  Object  Code  Creation 

To  create  the  IPC's  for  the  CICS  environment  requires  the 
CICS  preprocessor,  the  COBOL  compiler,  the  Assembler  and  the 
standard  link  editor  to  create  a  load  module  that  can  be 
referenced  when  linking  main  modules.  Except  for  the  CICS 
preprocessor,  the  same  mechanism  applies  for  creating  the  IPC 
load  library  under  MVS. 

To  create  the  IPC  library  on  the  Honeywell  Level  t 
requires  the  COBOL  compiler,  the  Assembler  and  the  standard 
1  inker. 

To  create  the  IPC  library  on  the  VAX  requires  the  COBOI 
and  FORTRAN  compilers  and  the  standard  linker. 
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3 . 9  Adaption  Data 

The  IPC's  are  system  dependent;  therefore,  they  must  be 
reimplemented  for  each  computer  and/or  operating  system. 

3 . 10  Detail  Design  Description 
3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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Module  Name  Purpose 


PS  620343200 
30  September  1990 


CNLTIM 

CRTMBX 

DELMBX 

ENDRUN 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 

WAIT03 


CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 
STOP  THE  PROGRAM 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 

IPC  Module  List 

Module  Name  Purpose 


CNLTIM 

CNLTMR 

CRTMBX 

DELMBX 

ENDRUN 

ERRFTL 

ERRPRO 

FREVTF 

GETMSG 

GETPNM 

LOCKEF 

RCVMSG 

RDMALF 

RELEVB 

SASGCH 

SCRTMB 

SDEACH 

SDELMB 

SETTIM 

SETTMR 


CANCEL  A  TIMER 
CANCEL  THE  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 
STOP  THE  PROGRAM 
PROCESS  FATAL  ERROR 
PROCESS  ERROR 
FREE  THE  EVENT  FLAG 
GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
GET  PROCESS  NAME 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

ASSIGN  A  CHANNEL  TO  A  MAILBOX 
CREATE  A  MAILBOX 

DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
DELETE  THE  MAILBOX 
START  A  TIMER 
SET  A  TIMER 
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Module 

SNDMSG 

SWEVTF 

VALMBE 

WAITOl 

WAIT02 

WAIT03 

WRTERR 

WRTMAI 
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IPC  Module  List 
Name  Purpose 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT  FOR  AN  EVENT  TO  OCCUR 
WRITE  MESSAGE  TO  MAILBOX 
WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 


IPC  External  Routines  List 


Module  Name 


LIB$FREE_EF 

LIB$GET_EF 

SYS$ASSIGN 

SYS$BINTIM 

SYS$CANTIM 

SYS$CLREF 

SYS$CREMBX 

SYS$DASSGN 

SYS$DELMBX 

SYS$GETDEV 

SYS$GETJPI 

SYS$QI0 

SYS$QIOW 

SYS$SETIMR 

SYS$SETRWM 

SYS$WAITFR 

SYS$WFL0R 


First  User 


SWEVTF 

WRTERR 

SASGCH 

WRTERR 

CNLTMR 

SWEVTF 

SCRTMB 

WRTERR 

SDELMB 

VALMBE 

GETPNM 

RDMALF 

WRTERR 

SETTMR 

SCRTMB 

WRTERR 

SWEVTF 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "****  PURPOSE  NOT  FOUND  BY  STRIPPER  ****" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C  libraries  that  are 
provided  with  the  'C  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 

IPC  Include  File  List 
File  Name  Purpose 


($JPIDEF)  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

CHKSTS  CHKSTS.INC  —  CHECK  STATUS 

ERRPRO  PROCESS  ERROR  INCLUDE  FILE 

ERRSTS  ERRSTS.INC  —  IISS  ERROR  CODES 

ERRSTS.INF  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

KIPC  KIPC.INC  --  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBEBOI  MBEBOI.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

MBEB02  MBEB02.INC  —  MAILBOX  EVt  1  BLOCK  DESCRIPTION 

MBEB03  MBEB03.INC  —  MAILBOX  EV^T  BLOCK  DESCRIPTION 

MBXEBK  MBXEBK.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

TIMREB  TIMREB.INC  --  TIME  EVENT  BLOCK  DESCRIPTION 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 


IPC  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


($JPIDEF) 

GETPNM  GET  PROCESS  NAME 


CHKSTS 

CNLTIM  CANCEL  A  TIMER 

CRTMBX  CREATE  A  MAILBOX 

DELMBX  DELETE  A  MAILBOX 

ERRFTL  PROCESS  FATAL  ERROR 

ERRPRO  PROCESS  ERROR 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

AND 

SETTIM  START  A  TIMER 

SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


ERRPRO 

CNLTIM  CANCEL  A  TIMER 

CRTMBX  CREATE  A  MAILBOX 

DELMBX  DELETE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

AND 

SETTIM  START  A  TIMER 

SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


3-10 


PS  620343200 
30  September  1990 


IPC  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


ERRSTS 

CNLTIM  CANCEL  A  TIMER 

CRTMBX  CREATE  A  MAILBOX 

DELMBX  DELETE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

AND 

SETTIM  START  A  TIMER 

SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


ERRSTS. INF 

CNLTMR  CANCEL  THE  TIMER 

GETPNM  GET  PROCESS  NAME 

LOCKEF  LOCK  EVENT  FLAG 

RDMALF  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

SASGCH  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

SCRTMB  CREATE  A  MAILBOX 

SDEACH  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
SDELMB  DELETE  THE  MAILBOX 

SETTMR  SET  A  TIMER 

VALMBE  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 

WRTMAI  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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IPC  Where-include-f ile-used  List 

Include  Module  Module 

File  Name  Purpose 


KIPC 

CRTMBX  CREATE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 


MBEBOl 

WAITOl  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBEB02 

WAIT02  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBEB03 

WAIT03  WAIT  FOR  AN  EVENT  TO  OCCUR 


MBXEBK 

CRTMBX  CREATE  A  MAILBOX 

DELMBX  DELETE  A  MAILBOX 

GETMSG  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RCVMSG  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 

AND 

SNDMSG  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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IPC  Where-include-f ile-used  List 


Include 

File 

Module 

Name 

Module 

Purpose 

TIMREB 

CNLTIM 

SETTIM 

CANCEL  A  TIMER 
START  A  TIMER 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 


IPC  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


LIB$FREE_EF 

FREVTF  FREE  THE  EVENT  FLAG 

SWEVTF  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
WRTERR  WRITE  MESSAGE  TO  MAILBOX 


LIB$GET_EF 

LOCKEF  LOCK  EVENT  FLAG 

RDMALF  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

SETTMR  SET  A  TIMER 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$ASSIGN 

SASGCH  ASSIGN  A  CHANNEL  TO  A  MAILBOX 
WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$BINTIM 

SETTMR  SET  A  TIMER 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$CANTIM 

CNLTMR  CANCEL  THE  TIMER 


SYS$CLREF 

SWEVTF  WAIT  FOR  ONE  OF  POSSIBIY  MANY  EVENTS 
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IPC  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SYS$CREMBX 

SCRTMB  CREATE  A  MAILBOX 


SYS$DASSGN 

SDEACH  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$DELMBX 

SDELMB  DELETE  THE  MAILBOX 


SYS$GETDEV 

VALMBE  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 


SYS$GETJPI 

GETPNM  GET  PROCESS  NAME 


SYS$QIO 

RDMALF  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 


SYS$QIOW 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 

WRTMAI  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 
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IPC  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


SYS$SETIMR 

SETTMR  SET  A  TIMER 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$SETRWM 

SCRTMB  CREATE  A  MAILBOX 


SYS$WAITFR 

WRTERR  WRITE  MESSAGE  TO  MAILBOX 


SYS$WFLOR 

SWEVTF  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  "well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 


IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CNLTIM 

Purpose- 

->CANCEL  A  TIMER 

CNLTMR 

Well-defined  module 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

FREVTF 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$CANTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 

3-17 


PS  620343200 
30  September  1990 


IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CRTMBX 

Purpose- 

->CREATE  A  MAILBOX 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SCRTMB 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$CREMBX 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETDEV 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$SETRWM 

External  routine 

SYS$WAITFR 

External  routine 

VALMBE 

Well-defined  module 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

DELMBX 

Purpose- 

->DELETE  A  MAILBOX 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SDEACH 

Well-defined  module 

SDELMB 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$DELMBX 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 
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I  PC  Ma 

Main  Pgm 
Name 


GETMSG 


1  Program  Parts  List 

Module  Module 

Name  Type 


Purpose — >GET  A  MESSAGE  FROM  ANOTHER 
PROGRAM 


ERRFTL 

ERRPRO 

FREVTF 

GETPNM 

LIB$FREE_EF 

LIB$GET_EF 

SYS$ASSIGN 

SYS$BINTIM 

SYS$DASSGN 

SYS$GETJPI 

SYS$QIOW 

SYS$SETIMR 

SYS$WAITFR 

WRTERR 


Well-defined  module 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 


3-20 


PS  620343200 
30  September  1990 


IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

LOCKEF 

Purpose- 

->LOCK  EVENT  FLAG 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


RCVMSG 


Purpose — >RECEIVE  A  MESSAGE  FROM  ANOTHER 
PROGRAM 


ERRFTL 

ERRPRO 

GETPNM 

LIB$FREE_EF 

LIB$GET_EF 

RDMALF 

SYS$ASSIGN 

SYS$BINTIM 

SYS$DASSGN 

SYS$GETJPI 

SYS$QIO 

SYS$QIOW 

SYS$SETIMR 

SYS$WAITFR 

WRTERR 


Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

RELEVB 

Purpose- 

->RELEASE  A  TARGET  EVENT  BLOCK 
(CLEAR  IT)  AND 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SDEACH 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QI0W 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SETTIM 

Purpose- 

->START  A  TIMER 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SETTMR 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parcs  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

SNDMSG 

Purpose- 

->SEND  A  MESSAGE  TO  ANOTHER 
PROGRAM 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SASGCH 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

WRTERR 

Well-defined  module 

WRTMAI 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAITOl 

Purpose- 

->WAIT  FOR  AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SWEVTF 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SyS$BINTIM 

External  routine 

SYS$CLREF 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

SYS$WFLOR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAIT02 

Purpose- 

->WAIT  FOR  AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SWEVTF 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$CLREF 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QI0W 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

SYS$WFLOR 

External  routine 

WRTERR 

Well-defined  module 
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IPC  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

WAIT03 

Purpose- 

->WAIT  FOR  AN  EVENT  TO  OCCUR 

ERRFTL 

Well-defined  module 

ERRPRO 

Well-defined  module 

GETPNM 

Well-defined  module 

LIB$FREE  EF 

External  routine 

LIB$GET  EF 

External  routine 

SWEVTF 

Well-defined  module 

SYS$ASSIGN 

External  routine 

SYS$BINTIM 

External  routine 

SYS$CLREF 

External  routine 

SYS$DASSGN 

External  routine 

SYS$GETJPI 

External  routine 

SYS$QIOW 

External  routine 

SYS$SETIMR 

External  routine 

SYS$WAITFR 

External  routine 

SYS$WFLOR 

External  routine 

WRTERR 

Well-defined  module 
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3.10.8  Module  Doc jmentation 

The  followifig  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 

Name  of  program  Module. 

PURPOSE: 

Purpose  of  Module  as  detailed  in  the 
source  code. 

LANGUAGE: 

Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-1  Workbench  'C 

VAX-11  COBOL 

MODULE  TYPE: 

Whether  a  Program,  Subroutine,  or 
Function. 

SOURCE  FILE: 

Name  of  Source  File  from  file 
specification. 

SOURCE  FILE  TYPE: 

Source  File  Extension  from  file 
specification. 

HOST: 

Whether  this  is  a  host-dependent 
routine  (VAX  or  IBM)  or  blank  if 
host-independent . 

SUBSYSTEM: 

IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY: 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 

DOCUMENTATION  GROUP: 

Name  of  documentation  group  of  which 
this  source  file  is  a  member. 

DESCRIPTION: 

A  description  of  the  module  as  otained 
from  the  source  code. 

ARGUMENTS: 

The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Function . 
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INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 


A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

The  documented  routines  which  call 
this  module,  if  any. 


USED  IN  MAIN  PROGRAM (S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 


IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GRO 


CNLTIM 

CANCEL  A  TIMER 

VAX- 11  COBOL 

SUBROUTINE 

CNLTIM 

.COB 

VAX 

IPC 


:  IPC 


DESCRIPTION: 


CANCEL  A  RUNNING  TIMER 


ARGUMENTS : 


TIMER-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 

INCLUDE  FILES: 


CHKSTS 

ERRSTS 

TIMREB 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

ERRSTS. INC  —  IISS  ERROR  CODES 

TIMREB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FREVTF  -  FREE  THE  EVENT  FLAG 

CNLTMR  -  CANCEL  THE  TIMER 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


CNLTMR 

CANCEL  THE  TIMER 

VAX- 11  FORTRAN 

SUBROUTINE 

CNLTMR 

.FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 


CANCEL  IISS  TIMER 
REQUEST  IDENTIFICATION  IS  4 


ARGUMENTS : 


RSTATS  =  CHAR 

-  RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

ROUTINES  CALLED: 

ERRPRO  -  PROCESS  ERROR 

SYS$CANTIM 

CALLED  DIRECTLY  BY: 

CNLTIM  -  CANCEL  A  TIMER 

USED  IN  MAIN  PROGRAM(S): 

CNLTIM  -  CANCEL  A  TIMER 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


CRTMBX 

CREATE  A  MAILBOX 

VAX- 11  COBOL 

SUBROUTINE 

CRTMBX 

•  COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


IT  CREATES  A  MAILBOX  THROUGH  WHICH  THE 
PROGRAM  WILL  RECEIVE  MESSAGES  FROM  ANOTHER 
PROGRAM  RUNNING  ON  THE  SAME  COMPUTER. 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 
MAILBOX-SIZE  =  DSPLY  [9(5)] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

KIPC 

MBXEBK 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

ERRSTS. INC  —  IISS  ERROR  CODES 

KIPC. INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


VALMBE 

SCRTMB 

ERRPRO 


VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 
CREATE  A  MAILBOX 
PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


DELMBX 

DELETE  A  MAILBOX 

VAX-11  COBOL 

SUBROUTINE 

DELMBX 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  DELETES  A  MAILBOX  WHEREBY  REMOVING 
THE  ABILITY  TO  RECEIVE  MESSAGES  FROM  ANOTHER 
PROGRAM  THROUGH  THE  GIVEN  INPUT  MAILBOX 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

MBXEBK 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 
ERRSTS. INC  —  IISS  ERROR  CODES 

MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SDELMB 

SDEACH 

ERRPRO 


DELETE  THE  MAILBOX 

DEASSIGN  CHANNEL  FROM  THE  MAILBOX 
PROCESS  ERROR 


3-33 


PS  620343200 
30  September  1990 


IPC  Module  Documentation 

NAME:  ENDRUN 


PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 

DESCRIPTION: 


-  THE  IBM  NEEDS  A 
STOP  THE  PROGRAM, 


STOP  THE  PROGRAM 

VAX-11  COBOL 

PROGRAM 

ENDRUN 

.COB 

VAX 

IPC 

IPC 


SPECIAL  ROUTINE  TO 
THEREFORE  WE  ALL  DO. 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ERRFTL 

PROCESS  FATAL  ERROR 
VAX- 11  COBOL 
SUBROUTINE 
ERP.FTL 
•  COB 

ERR 

IPC 


-  This  module  date  and  time  stamps  the 
error  message,  assigns  a  function  code 
and  writes  the  error  message  to  a 
file  called  ERRFTL 


ARGUMENTS : 


RET-STATUS  =  DSPLY  [X(5)] 
MODULE-NAME  =  DSPLY  [X(6)] 
MESG-DESC  =  DSPLY  [X(60)] 
ORIGINAL-ERR-MSG  =  DSPLY  [X(109)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS.INC  —  CHECK  STATUS 


ROUTINES  CALLED: 


GETPNM  -  GET  PROCESS  NAME 


CALLED  DIRECTLY  BY: 

ERRPRO  -  PROCESS  ERROR 


USED  IN  MAIN  PROGRAM(S) : 


CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 


CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
LOCK  EVENT  FLAG 

RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 
START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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WAITOl  -  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT02  -  WAIT  FOR  AN  EVENT  TO  OCCUR 
WAIT03  -  WAIT  FOR  AN  EVENT  TO  OCCUR 
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ifC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


ERRPRO 

PROCESS  ERROR 

VAX- 11  COBOL 

SUBROUTINE 

ERRPRO 

.COB 

ERR 

I  PC 


DESCRIPTION: 


LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 


ARGUMENTS : 


RET-STATUS  =  DSPLY  [X(5)] 
MODULE-NAME  =  DSPLY  [X(6)] 
MESG-DESC  =  DSPLY  [X(60) ] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS.INC  —  CHECK  STATUS 


ROUTINES  CALLED: 


GETPNM  -  GET  PROCESS  NAME  ** 
WRTERR  -  WRITE  MESSAGE  TO  MAILBOX  ** 
ERRFTL  -  PROCESS  FATAL  ERROR 


CALLED  DIRECTLY  BY: 


CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 

WAIT03 

CNLTMR 

FREVTF 

LOCKEF 

RDMALF 


CANCEL  A  TIMER 
CREATE  A  MAILBOX 
DELETE  A  MAILBOX 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 
RELEASE  A  TARGET  EVEN'^  BLOCK  (CLEAR  IT)  AND 
START  A  TIMER 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT  FOR  AN  EVENT  TO  OCCUR 

CANCEL  THE  TIMER 

FREE  THE  EVENT  FLAG 

LOCK  EVENT  FLAG 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 
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SASGCH 

SCRTMB 

SDEACH 

SDELMB 

SETTMR 

SWEVTF 

VALMBE 

WRTMAI 


USED  IN  MAIN 


CNLTIM 
CRTMBX 
DELMBX 
GETMSG 
LOCKE F 
RCVMSG 
RELEVB 
SETTIM 
SNDMSG 
WAITOl 
WAIT02 
WAIT03 


-  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

-  CREATE  A  MAILBOX 

-  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

-  DELETE  THE  MAILBOX 

-  SET  A  TIMER 

-  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

-  VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

-  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 


PROGRAM (S) : 


-  CANCEL  A  TIMER 

-  CREATE  A  MAILBOX 

-  DELETE  A  MAILBOX 

-  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  LOCK  EVENT  FLAG 

-  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

-  START  A  TIMER 

-  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


FREVTF 

FREE  THE  EVENT  FLAG 

VAX- 11  FORTRAN 

SUBROUTINE 

FREVTF 

.FOR 

VAX 

IPC 

IPC 


:-  THIS  MODULE  RELEASES  AN  EVENT  FLAG  THAT 
WAS  PREVIOUSLY  OBTAINED  FROM  THE  SYSTEM. 


ARGUMENTS : 


EVTFLG  =  1*2 

RSTATS  =  CHAR 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIB$FREE  EF 


CALLED  DIRECTLY  BY: 


CNLTIM  -  CANCEL  A  TIMER 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 


USED  IN  MAIN  PROGRAM(S): 


CNLTIM  -  CANCEL  A  TIMER 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


GETMSG 

GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

VAX- 11  COBOL 

SUBROUTINE 

GETMSG 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  ACCEPTS  THE  MESSAGE  THAT  WAS  SENT  FROM 
ANOTHER  PORGRAM  RUNNING  ON  THE  SAME  COMPUTER 
AND  MOVES  IT  INTO  THE  GIVEN  BUFFER. 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 
BUFFER  =  DSPLY  [X(2000)] 
BUFFER-SIZE  =  DSPLY  [9(4)] 
NUMBER-OF-BYTES  =  DSPLY  [9(4)] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

KIPC 

ERRSTS 

MBXEBK 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

KIPC. INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 
ERRSTS. INC  —  IISS  ERROR  CODES 

MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FREVTF  -  FREE  THE  EVENT  FLAG 

ERRPRO  -  PROCESS  ERROR 


3-40 


PS  620343200 
30  September  1990 


IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST : 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


GETPNM 

GET  PROCESS  NAME 
VAX- 11  FORTRAN 
SUBROUTINE 
GETPNM 
.FOR 

ERR 

IPC 


DESCRIPTION: 


GET  THE  NAME  OF  THE  CALLING  PROCESS 


ARGUMENTS : 


PRCNAM  =  CHAR 

-  Process  name 
RSTATS  =  CHAR 

-  Return  status 

INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
($JPIDEF)  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


SYS$GETJPI 


CALLED  DIRECTLY  BY : 


ERRFTL  -  PROCESS  FATAL  ERROR 

ERRPRO  -  PROCESS  ERROR 


USED  IN  MAIN  PROGRAM(S): 


CNLTIM  -  CANCEL  A  TIMER 

CRTMBX  -  CREATE  A  MAILBOX 

DELMBX  -  DELETE  A  MAILBOX 

GETMSG  -  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

LOCKEF  -  LOCK  EVENT  FLAG 

RCVMSG  -  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

SETTIM  -  START  A  TIMER 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

WAITOl  -  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT02  -  WAIT  FOR  AN  EVENT  TO  OCCUR 

WAIT03  -  WAIT  FOR  AN  EVENT  TO  OCCUR 
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IPC  Module  Documentation 


NAME; 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST; 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


LOCKEF 

LOCK  EVENT  FLAG 

VAX- 11  FORTRAN 

SUBROUTINE 

LOCKEF 

.FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 

:-  LOCK  EVENT  FLAG  FROM  BEING  USED  UNTIL  FREED. 


INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIB$GET  EF 
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IPC  Module  Documentation 


NAME:  RCVMSG 

PURPOSE:  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  RCVMSG 

SOURCE  FILE  TYPE:  .COB 

HOST:  VAX 

SUBSYSTEM:  IPC 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  IPC 

DESCRIPTION: 


ARGUMENTS : 


INPUT-MAILBOX-NAME  =  DSPLY  [X(14)] 
EVENT-NUMBER  =  DSPLY  [99] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS.INC  --  CHECK  STATUS 

ERRSTS  -  ERRSTS.INC  --  IISS  ERROR  CODES 

KIPC  -  KIPC.INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBXEBK  -  MBXEBK.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


RDMALF  -  READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RDMALF 

READ  THE  MAILBOX  FOR  EVENT  FLAG  SET 

VAX- 11  FORTRAN 

SUBROUTINE 

RDMALF 

.FOR 

VAX 

IPC 


TPC 


DESCRIPTION: 


ISSUE  QIO  WITH  EVENT  FLAG  TO  READ  MESSAGE 
FROM  MAILBOX  USING  THE  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL  =  1*2 

-CHANNEL  NUMBER 
EVTFLG  =  1*2 

-EVENT  FLAG 
EVTBLK  =  L*1  (1) 

-MAILBOX  EVENT  BLOCK 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIB$GET_EF 

SYS$QIO 


CALLED  DIRECTLY  BY: 


RCVMSG 

-  RECEIVE  A 

MESSAGE 

FROM 

ANOTHER 

PROGRAM 

USED  IN  MAIN 

PROGRAM (S) : 

RCVMSG 

-  RECEIVE  A 

MESSAGE 

FROM 

ANOTHER 

PROGRAM 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RELEVB 

RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT) 
AND 

VAX- 11  COBOL 

SUBROUTINE 

RELEVB 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  DEASSIGN  THE  CHANNEL  ASSIGNED  TO  THE 
TARGET  MAILBOX. 


ARGUMENTS : 


TARGET-MAILBOX-NAME  =  DSPLY  [X(14)] 
MAILBOX-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [:X(5)] 


INCLUDE  FILES: 


ERRSTS 

CHKSTS 

MBXEBK 

ERRPRO 


ERRSTS. INC  —  IISS  ERROR  CODES 
CHKSTS . INC  —  CHECK  STATUS 

MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SDEACH  -  DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME :  SASGCH 

PURPOSE:  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

LANGUAGE:  VAX-11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  SASGCH 

SOURCE  FILE  TYPE:  .FOR 

HOST:  VAX 

SUBSYSTEM:  IPC 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  IPC 

DESCRIPTION: 


: -ASSIGN  A  CHANNEL  NUMBER  TO  MAILBOX 


ARGUMENTS : 


MBXNAM  =  CHAR 

-MAILBOX  NAME 
CHANNL  =  1*2 

-CHANNEL  NUMBER 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

SYS$ASSIGN 


CALLED  DIRECTLY  BY: 


SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 


USED  IN  MAIN  PROGRAM (S): 


SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 


3-46 


PS  620343200 
30  September  1990 


IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 


3CRTMB 

CREATE  A  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

SCRTMB 

.FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 


:-  TO  CREATE  A  MAILBOX  USING  THE  NAME  AND  THE 
SIZE  SPECIFIED.  IT  ALSO  DISABLES  THE  RESOURCE 
WAIT  MODE  TO  ALLOW  CONTROL  RETURN  TO  CALLING  PROGRAM 
IMMEDIATELY  WITHOUT  WAITING  FOR  THE  RESOURCE 
TO  BE  AVAILABLE,  SUCH  AS  THE  MAILBOX  FULL. 

ARGUMENTS : 


MBXNAM  =  CHAR 

-MAILBOX  NAME 
MBXSIZ  =  1*2 

-MAILBOX  SIZE 
CHANNL  =  1*2 

-CHANNEL  NUMBER 
RSTATS  =  CHAR 

-RETURN  STATUS 

INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

ROUTINES  CALLED: 

ERRPRO  -  PROCESS  ERROR 

SYS$CREMBX 

SYS$SETRWM 

CALLED  DIRECTLY  BY: 

CRTMBX  -  CREATE  A  MAILBOX 

USED  IN  MAIN  PROGRAM (S) : 


CRTMBX 


CREATE  A  MAILBOX 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SDEACH 

DEASSIGN  CHANNEL  FROM  THE  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

SDEACH 

•  FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 


: -DEASSIGN  A  MAILBOX  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL  =  1*2 

-CHANNEL  NUMBER 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

ROUTINES  CALLED: 

ERRPRO  -  PROCESS  ERROR 

SYS$DASSGN 

CALLED  DIRECTLY  BY: 


DELMBX  -  DELETE  A  MAILBOX 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

USED  IN  MAIN  PROGRAM (S) : 


DELMBX  -  DELETE  A  MAILBOX 

RELEVB  -  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE ; 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


SDELMB 

DELETE  THE  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

SDELMB 

.  FOR 

VAX 

IPC 

IPC 


:-  TO  DELETE  A  MAILBOX  USING  THE  CHANNEL  NUMBER 


ARGUMENTS : 


CHANNL  =  1*2 

-CHANNEL  NUMBER 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

SYS$DELMBX 


CALLED  DIRECTLY  BY: 


DELMBX  -  DELETE  A  MAILBOX 


USED  IN  MAIN  PROGRAM(S): 


DELMBX  -  DELETE  A  MAILBOX 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GRO 

DESCRIPTION: 


SETTIM 

START  A  TIMER 

VAX- 11  COBOL 

SUBROUTINE 

SETTIM 

.COB 

VAX 

IPC 

:  IPC 


REQUEST  A  TIMER  TO  START  RUNNING.  THE 
PROGRAM  CONTINUES  TO  EXECUTE  WITH  THE 
ELAPSED  TIME  BEING  DISCOVERED  IN  THE 
WAITED  PRIMITIVE. 


ARGUMENTS : 


TIME-INTERVAL  =  RECRD 
EVENT-NUMBER  =  DSPLY  [99] 
TIMER-EVENT-BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

TIMREB 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

ERRSTS. INC  —  IISS  ERROR  CODES 

TIMREB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SETTMR  -  SET  A  TIMER 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP 

DESCRIPTION: 


SETTMR 
SET  A  TIMER 
VAX- 11  FORTRAN 
SUBROUTINE 
SETTMR 
.FOR 
VAX 
IPC 

:  IPC 


SET  A  TIMER  WITH  AN  EVENT  FLAG 
REQUEST  IDENTIFICATION  IS  4 


ARGUMENTS : 


INTVAL 

EVTFLG 

RSTATS 


CHAR 

TIME  INTERVAL  -  HHMMSS 
1*2 

EVENT  FLAG  NUMBER 
CHAR 

RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIB$GET_EF 

SYS$BINTIM 

SYS$SETIMR 


CALLED  DIRECTLY  BY: 

SETTIM  -  START  A  TIMER 

USED  IN  MAIN  PROGRAM(S): 

SETTIM  -  START  A  TIMER 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


SNDMSG 

SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

VAX- 11  COBOL 

SUBROUTINE 

SNDMSG 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  SENDS  A  MESSAGE  TO  ANOTHER  PROGRAM 
RUNNING  ON  THE  SAME  COMPUTER  THROUGH  THE 
INPUT  MAILBOX  OF  THE  OTHER  PROGRAM. 


ARGUMENTS : 


TARGET -MAILBOX -NAME  =  DSPLY  [X(14)] 
BUFFER  =  DSPLY  [X(2000)] 
NUMBER-OF-BYTES  =  DSPLY  [9(4)] 
MAILBOX- EVENT- BLOCK  =  RECRD 
RET-STATUS  =  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

KIPC 

MBXEBK 

ERRPRO 


CHKSTS. INC  —  CHECK  STATUS 

ERRSTS. INC  —  IISS  ERROR  CODES 

KIPC. INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


WRTMAI  -  WRITE  THE  MESSAGE  INTO  THE  MAILBOX 

SASGCH  -  ASSIGN  A  CHANNEL  TO  A  MAILBOX 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


SWEVTF 

WAIT  FOR  ONE  OF  POSSIi  '  MANY  EVENTS 

VAX- 11  FORTRAN 

SUBROUTINE 

SWEVTF 

.FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 


:-  THIS  MODULE  SET  UP  THE  EVENT  CLUSTER  AND  WAITS 
FOR  ONE  OF  THE  EVENT  TO  HAPPEN. 


ARGUMENTS : 


ENARRY  = 
EVTFLG  = 
EVTNUM  = 
RSTATS  = 


1*2  (22) 
1*2  (22) 
1*2 
CHAR 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

LIB$FREE_EF 

SYS$CLREF 

SYS$WFLOR 


CALLED  DIRECTLY  BY: 


WAITOl 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 

WAIT02 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 

WAIT03 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 

USED  IN  MAIN 

PROGRAM (S) : 

WAITOl 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 

WAIT02 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 

WAIT03 

-  WAIT 

FOR 

AN 

EVENT 

TO 

OCCUR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


VALMBE 

VALIDATE  THAT  MAILBOX  ALREADY  EXISTS 

VAX- 11  FORTRAN 

SUBROUTINE 

VALMBE 

•  FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 


:-  THIS  MODULE  CHECKS  TO  SEE  IF  MAILBOX 
ALREADY  EXISTS. 


ARGUMENTS : 


INMBNM  =  CHAR 

-INPUT  MAILBOX  NAME 
RSTATS  =  CHAR 

-RET  STATUS 


INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


ERRPRO  -  PROCESS  ERROR 

SYS$GETDEV 


CALLED  DIRECTLY  BY: 


CRTMBX  -  CREATE  A  MAILBOX 


USED  IN  MAIN  PROGRAM(S) : 


CRTMBX  -  CREATE  A  MAILBOX 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


WAITOl 

WAIT  FOR  AN  EVENT  TO  OCCUR 

VAX- 11  COBOL 

SUBROUTINE 

WAITOl 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  =  DSPLY  [99] 

RET-STATUS  =  DSPLY  [X(5)] 
NUMBER-OF-EVENT-BLOCKS  =  DSPLY  [99] 
MBX-EVENT-BLOCK-01  =  RECRD 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS.INC  —  CHECK  STATUS 

ERRSTS  -  ERRSTS.INC  —  IISS  ERROR  CODES 

MBEBOl  -  MBEBOl.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SWEVTF  -  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


WAIT02 

WAIT  FOR  AN  EVENT  TO  OCCUR 

VAX- 11  COBOL 

SUBROUTINE 

WAIT02 

.COB 

VAX 

IPC 

IPC 


DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  =  DSPLY  [99] 

RET-STATUS  =  DSPLY  [X(5)] 
NUMBER-OF-EVENT-BLOCKS  =  DSPLY  [99] 
MBX-EVENT-BLOCK-01  =  RECRD 
MBX-EVENT-BLOCK-02  =  RECRD 


INCLUDE  FILES: 


CHKSTS 

ERRSTS 

MBEBOl 

MBEB02 

ERRPRO 


CHKSTS. INC  — 
ERRSTS. INC  — 
MBEBOl. INC  -- 
MBEB02.INC  — 
PROCESS  ERROR 


CHECK  STATUS 

IISS  ERROR  CODES 

MAILBOX  EVENT  BLOCK  DESCRIPTION 

MAILBOX  EVENT  BLOCK  DESCRIPTION 

INCLUDE  FILE 


ROUTINES  CALLED: 


SWEVTF  -  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME:  WAIT03 

PURPOSE:  WAIT  FOR  AN  EVENT  TO  OCCUR 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  WAIT03 

SOURCE  FILE  TYPE:  .COB 

HOST:  VAX 

SUBSYSTEM:  IPC 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  IPC 

DESCRIPTION: 


-  IT  WAITS  FOR  ONE  OF  OUTSTANDING  REQUESTS  THAT 
ARE  ASSOCIATED  WITH  THE  LIST  OF  EVENT  BLOCKS 
TO  BE  SATISFIED.  THE  EVENT  NUMBER  ASSOCIATED 
WITH  THE  COMPLETED  REQUEST  IS  RETURNED  IN  THE 
EVENT  NUMBER  VARIABLE. 


ARGUMENTS : 


EVENT-NUMBER  =  DSPLY  [99] 

RET-STATUS  =  DSPLY  [X(5)] 
NUMBER-OF-EVENT-BLOCKS  =  DSPLY  [99] 
MBX-EVENT-BLOCK-01  =  RECRD 
MBX-EVENT-BLOCK-02  =  RECRD 
MBX-EVENT-BLOCK-03  =  RECRD 


INCLUDE  FILES: 


CHKSTS  -  CHKSTS.INC  —  CHECK  STATUS 
ERRSTS  -  ERRSTS.INC  —  IISS  ERROR  CODES 

MBEBOl  -  MBEBOl.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
MBEB02  -  MBEB02.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
MBEB03  -  MBEB03.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 
ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


SWEVTF  -  WAIT  FOR  ONE  OF  POSSIBLY  MANY  EVENTS 

ERRPRO  -  PROCESS  ERROR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


WRTERR 

WRITE  MESSAGE  TO  MAILBOX 
VAX- 11  FORTRAN 
SUBROUTINE 
WRTERR 
.FOR 

ERR 

IPC 


DESCRIPTION: 


:-  ISSUE  QIO  TO  WRITE  A  MESSAGE  TO  MAILBOX 


ARGUMENTS : 


MBXNAM  =  CHAR 

-MAILBOX  NAME 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
INBUF  =  L*1  (1) 

-MESSAGE 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 


ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


ROUTINES  CALLED: 


LIB$FREE_EF 

LIB$GET_EF 

SYS$ASSIGN 

SYS$BINTIM 

SYS$DASSGN 

SYS$QIOW 

SYS$SETIMR 

SYS$WAITFR 

CALLED  DIRECTLY  BY: 


ERRPRO  -  PROCESS  ERROR 
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USED  IN  MAIN 


CNLTIM 

CRTMBX 

DELMBX 

GETMSG 

LOCKEF 

RCVMSG 

RELEVB 

SETTIM 

SNDMSG 

WAITOl 

WAIT02 

WAIT03 


PROGRAM (S) : 


-  CANCEL  A  TIMER 

-  CREATE  A  MAILBOX 

-  DELETE  A  MAILBOX 

-  GET  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  LOCK  EVENT  FLAG 

-  RECEIVE  A  MESSAGE  FROM  ANOTHER  PROGRAM 

-  RELEASE  A  TARGET  EVENT  BLOCK  (CLEAR  IT)  AND 

-  START  A  TIMER 

-  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 

-  WAIT  FOR  AN  EVENT  TO  OCCUR 
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IPC  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


WRTMAI 

WRITE  THE  MESSAGE  INTO  THE  MAILBOX 

VAX- 11  FORTRAN 

SUBROUTINE 

WRTMAI 

.FOR 

VAX 

IPC 

IPC 


DESCRIPTION: 

:-  ISSUE  QIO  TO  WRITE  A  MESSAGE  TO  MAILBOX 


ARGUMENTS : 


CHANNL  =  1*2 

-CHANNEL  NUMBER 
BUFLEN  =  1*2 

-MAXIMUM  BUFFER  LENGTH 
INBUF  =  L*1  (1) 

-MESSAGE 
RSTATS  =  CHAR 

-RETURN  STATUS 


INCLUDE  FILES: 

ERRSTS.INF  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

ROUTINES  CALLED: 

ERRPRO  -  PROCESS  ERROR 

SYS$QIOW 

CALLED  DIRECTLY  BY: 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 

USED  IN  MAIN  PROGRAM(S) : 

SNDMSG  -  SEND  A  MESSAGE  TO  ANOTHER  PROGRAM 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 


IPC  Include  File  Description 


FILE  NAME:  CHKSTS 

PURPOSE:  CHKSTS. INC  —  CHECK  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IPC  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IPC  Include  File  Description 


FILE  NAME:  ERRSTS 

PURPOSE:  ERRSTS. INC  —  IISS  ERROR  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  FILE  CONTAINS  ALL  IISS  ERROR  CODES  DEFINED  IN  * 
COBOL  FORMAT  * 
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IPC  Include  File  Description 


FILE  NAME:  KIPC 

PURPOSE:  KIPC. INC  —  CONSTAND  BLOCK  FOR  IPC  PRIMITIVES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  FILE  CONTAINS  ALL  CONSTANT  DATA  ITEMS  * 

USED  IN  THE  IPC  PRIMITIVES.  * 


IPC  Include  File  Description 


FILE  NAME:  MBEBOl 

PURPOSE:  MBEBOl. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


IPC  Include  File  Description 


FILE  NAME:  MBEB02 

PURPOSE:  MBEB02.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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IPC  Include  File  Description 


FILE  NAME:  MBEB03 

PURPOSE:  MBEB03.INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IPC  Include  File  Description 


FILE  NAME:  MBXEBK 

PURPOSE:  MBXEBK. INC  —  MAILBOX  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


IPC  Include  File  Description 


FILE  NAME:  TIMREB 

PURPOSE:  TIMREB. INC  —  TIME  EVENT  BLOCK  DESCRIPTION 

LANGUAGE:  VAX- 11  COBO!. 

DESCRIPTION: 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 


There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 


+ - + 

I CNLTIMl 
+ - 2  + 


+  “ - —  —  + 

I CRTMBX I 
+ - 3  + 


+ - + 

I DELMBXl 
+ - 4+ 

+ 


I GETMSG I 
+ — + + 

I 

- + - + 


I LOCKEFi 
+ - 5+ 


1 

+  - — - -t" 

I  (CONT)  I 

+  ■*“■“■“"■64- 


+——+—“—+  +““+“““+ 
1 FREVTF 1  1 ERRPRO ] 

+ - 2+  + - 7  + 
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2 

+ - + 

|CNLTIM| 

+  — + - + 

I 

+ - + - + - + 

I  I  i 

- — -f-  — — — -j-  -l-_ — I — 

|FREVTF|  [CNLTMRl  | ERRPRO | 

+ — + - +  + — + - +  + - 7  + 

^  ___  I  _ I _ ^ 

I  ^  I  I  ^  I 

+ — + - +  + - + - +  + — + - +  + - + - + 

1 ERRPRO j  I LIB$FREE_EF[  j ERRPRO |  |SYS$CANTIM| 

+ - 7+  + - +  + - 7+  + - + 


3-66 


PS  620343200 
30  September  1990 


+ - + 

I CRTMBX I 

-t- — + - + 


+ — + - + 

I VALMBE  I 
+ — + + 


+  H —  — -f  — —  —  + 

I SCRTMB I  I ERRPRO ) 
+ — + +  + - 7  + 


-++- 


+  — + - +  + - + - +  + — + - +  + - + - +  + - + - + 


I ERRPRO I 
+ - 7  + 


SYS$GETDEV| 


I ERRPRO I 
+ - 7  + 


|SYS$CREMBX| 
+ - + 


I SYS$SETRWM| 
+ - + 
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( DELMBX I 
+ — + + 


+ - 

I 

+ — + - + 

1 SDELMB] 

+ — + - + 

_ I _ ^ 

I  ^  I 

+ — + - +  + - + - + 

lERRPROl  lSYS$DELMBX| 
+ - 7+  + - + 


— + - + - + 

I  I 

-t - i — — — +  - + 

I SDEACH I  I ERRPRO | 
+ — + +  + - 7  + 

^ _ j _ ^ 

I  "  I 

-f — — — — 4-— — — 

I ERRPRO I  |SYS$DASSGN| 

+ - 7+  + - + 
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5 

+ - + 

I LOCKEF I 
+ — + + 

I 

+ - + - + 

!  I 

- 1 - (-  -( - 1 - 

ERRPROl  |LIB$GET_EFl 

- 7+  + - + 
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I  (CONT)  I 
+ - 1+ 


+ - + 

I RCVMSG 1 

4- - 8  + 


+ - + 

I RELEVB 1 
+ — + + 


+ - + 

I SETTIMl 
+ - 9  + 


+ - + 

I SNDMSG] 
4- 104- 


H - —  *  — —  + 

I  (CONT)  I 

+ - 114 


6 


4 - 4 - 4 

I SDEACH] 

4 - 44 


4__4 - + 

I ERRPRO 1 

4 - 74 


PS  620:i43200 
30  September  1990 


+ - + 

I ERRPRO I 

+ — + + 

I 

+ - + - + 

I  I  I 

+ — + - +  + — t - +  + — + - + 

jGETPNM]  |WRTERRj  |ERRFTL| 

+ — + +  + 12+  + — + + 


+ — + - + 

I GETPNM I 
+ - 7  + 


I SYS$GETJPI I 
+ - + 
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+ - + 

1 RCVMSG I 
+  — + + 

+ - + - + 


4- — + - +  + — + + 

I RDMALF I  1 ERRPRO | 


+ — + - +  +- 

i 

- 7  + 

1 

{ 

1 

1 

+ — + - + 

i-  + 

1 

+ - + - + 

1 ERRPRO 1 

1 LIB$GET  EFl 

1  SYS$QIO| 

+ - 7  + 

+ - + 

+ - + 

► 
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+  - h 

[SETTIMj 
+  — + + 

I 

+ - + - + 


I”” 
+ — + - + 

( ERRPRO I 
+ - 7  + 


+ — + - +  + — + - + 

|SETTMR|  I ERRPRO I 
+ — + +  + - 7  + 


+ 


I LIB$GET_EF| 
+ - + 


+ - + - 

(SYS$BINTIM( 
- + 


- + 

_ ^ 

isYS$SETIMR| 
+ - + 
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I SNDMSG I 
+ — + + 


+ - 1 - 1-  -( - 1 - h  H - i - h 

1 WRTMAI I  I SASGCH |  | ERRPRO ] 

+ — + - +  + — + - +  + - 7  + 


H - 1 - H  + - 1- - 1-  3 - 1 - 1-  3 - 1 - H 

1 ERRPRO 1  lSYS$QIOWi  ( ERRPRO |  iSYS$ASSIGNl 
+  “**“““•"7+  - —  —  — — -f.  ^  — 
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H - - (-  H - (-  H - f-  + - j- 

I (CONT) I  |WAIT01|  |WAIT02l  lWAIT03| 

+ - 6+  + - 13+  +  —  + - +  +  —  + - + 


+ - + - +  + - + - + 

I  I  I  I 

+ - 1 - +  H - 1 - +  ^ - 1 - H  H - 1 - h 

ISWEVTFl  |ERRPRO|  | SWEVTF |  | ERRPRO | 

+ 13+  + - 7+  + 13+  + - 7  + 
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+ - + 


I WRTERR 1 
+ — + + 


+ 


LIB$FREE  EF| 


- + - + - h - 

lLIB$GET_EFl  |SYS$ASSIGN 


I 

I 

+  --  + - 

i  (CONT)  I 


12 
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+ - + 

I WAITOl I 
+ — + + 

I 

+ - + - + 


+ — + - +  + — + - + 

I SWEVTF I  1 ERRPRO | 

+  --+ - +  + - 7  + 

I 

+ - + - + - + - + 

1111 
+ — + - +  + - + - +  + - + - +  + - + - + 

I ERRPRO I  I LIB$FREE_EF|  |SYS$CLREF|  |SYS$WFLOR| 
+ - 7+  + - +  + - +  + - + 


t 


> 


3-76 


PS  620343200 
30  September  1990 


I WRTERRj 
+  --+ - + 


14 


+  --1 - + 


!  (CONT)  I 
+ - 12  + 


+ - + - + 

I SYS$BINTIMl 
+ - + 


'""'^1  I 
+ - + - +  + - + - + 

lSYS$DASSGNj  lSYS$QIOWl 
+ - +  + - + 


+ 


+  --  + - -»■ 

1  (CONT)  ! 
+ - 15-i- 
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-( - — 

( WRTERR I 
+  — + + 


+ - +  + - + 

I  I  I 

+  —  + - +  + - + - +  + - + - + 

I (CONT) 1  |SYS$SETIMRl  |SYS$WAITFR| 
+ 14+  + - +  + - + 


t 
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CNLTIM . 2 

CNLTMR . 2 

CRTMBX . 3 

DELMBX . 4 

ERRFTL . 7 

ERRPRO . 7 

EREVTF . 2 

GETMSG . 1 

GETPNM . 7 

LIB$FREE_EF 

LIB$GET_EF 

LOCKEF . 5 

RCVMSG . 8 

RDMALF . 8 

RELEVB . 6 

SASGCH . 10 

SCRTMB . 3 

SDEACH . 4 

SDELMB . 4 

SETTIM . 9 

SETTMR . 9 

SNDMSG . 10 

SWEVTF . 13 


SYS$ASSIGN 

SYS$BINTIM 

SYS$CANTIM 

SYS$CLREF 

SYS$CREMBX 

SYS$DASSGN 

SYS$DELMBX 

SYS$GETDEV 

SYS$GETJPI 

SYS$QIO 

SYS$QIOW 

SYS$SETIMR 

SYS$SETRWM 

SYS$WAITFR 

SYS$WFLOR 


VALMBE . 3 

WAITOl . 13 

WAIT02 . 11 

WAIT03 . 11 

WRTERR . 12 

WRTMAI . 10 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions 
section  3.10. 


in 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  IS  practical  and  possible  in  each  routine  should  be 
performed. 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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